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Foreword 



This Technical Specification has been produced by the 3' Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 
where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



The present document is part 4, sub-part 4 of a multi-part TS covering the 3' Generation Partnership Project: Technical 
Specification Group Core Network; Open Service Access (OSA); Application Programming Interface (API), as 
identified below. The API specification (3GPP TS 29.198) is structured in the following Parts: 



Parti: 
Part 2: 
Part 3: 
Part 4: 



Parts 
Part 6 
Part? 
Parts 
Part 9 
Part 10 
Part 11 
Part 12 
Part 13 
Part 14 



"Overview"; 

"Common Data Definitions"; 

"Framework"; 

"Call Control"; 

Sub-part 1: "Call Control Common Definitions"; 

Sub-part 2: "Generic Call Control SCF"; 

Sub-part 3: "Multi-Party Call Control SCF"; 

Sub-part 4: "Multi-Media Call Control SCF"; 

Sub-part 5: "Conference Call Control SCF"; 

"User Interaction SCF"; 

"Mobility SCF"; 

"Terminal Capabihties SCF"; 

"Data Session Control SCF"; 

"Generic Messaging SCF"; 

"Connectivity Manager SCF"; 

"Account Management SCF"; 

"Charging SCF". 

"Policy Management SCF"; 

"Presence and Availability Management SCF"; 



(new in 3GPP Release 5) 
(new in 3GPP Release 5) 
(new in 3GPP Release 5) 
(new in 3GPP Release 5) 
(not part of 3GPP Release 5) 



(not part of 3GPP Release 5) 
(not part of 3GPP Release 5) 



(new in 3GPP Release 5) 
(new in 3GPP Release 5) 



The Mapping specification of the OSA APIs and network protocols (3GPP TR 29.998) is also structured as above. 
A mapping to network protocols is however not applicable for all Parts, but the numbering of Parts is kept. 
Also in case a Part is not supported in a Release, the numbering of the parts is maintained. 
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Table: Overview of the OSA APIs & Protocol Mappings 29.198 & 29.998-faniily 



OSA API specifications 29.198-family 


OSA API Mapping - 29.998-family 


29.198-01 


Overview 


29.998-01 


Overview 


29.198-02 


Common Data Definitions 


29.998-02 


Not Applicable 


29.198-03 


Framework 


29.998-03 


Not Applicable 


Call 
Control 

(CC) 
SCF 


29.198- 
04-1 

Common 
CC data 
definitions 


29.198- 
04-2 
Generic 
CCSCF 


29.198- 
04-3 
Multi- 
Party CC 
SCF 


29.198- 
04-4 
Multi- 
media CC 
SCF 


29.998-04-1 


Generic Call Control - CAP mapping 


29.998-04-2 


Generic Call Control — INAP mapping 


29.998-04-3 


Generic Call Control — Megaco mapping 


29.998-04-4 


Multiparty Call Control - SIP mapping 


29.198-05 


User Interaction SCF 


29.998-05-1 


User Interaction - CAP mapping 


29.998-05-2 


User Interaction — INAP mapping 


29.998-05-3 


User Interaction - Megaco mapping 


29.998-05-4 


User Interaction - SMS mapping 


29.198-06 


Mobility SCF 


29.998-06 


User Status and User Location - MAP mapping 


29.198-07 


Terminal Capabilities SCF 


29.998-07 


Not Applicable 


29.198-08 


Data Session Control SCF 


29.998-08 


Data Session Control - CAP mapping 


29.198-09 


Generic Messaging SCF 


29.998-09 


Not Applicable 


29.198-10 


Connectivity Manager SCF 


29.998-10 


Not Applicable 


29.198-11 


Account Management SCF 


29.998-11 


Not Applicable 


29.198-12 


Charging SCF 


29.998-12 


Not Applicable 


29.198-13 


Policy Management SCF 


29.998-13 


Not Applicable 


29.198-14 


Presence & Availability Management SCF 


29.998-14 


Not Applicable 
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Scope 



The present document is Part 4, Sub-part 4 of the Stage 3 specification for an Apphcation Programming Interface (API) 
for Open Service Access (OSA). 

The OSA specifications define an architecture that enables application developers to make use of network functionality 
through an open standardised interface, i.e. the OSA APIs. The concepts and the functional architecture for the OSA are 
contained in 3GPP TS 23.127 [3]. The requirements for OSA are contained in 3GPP TS 22.127 [2]. 

The present document specifies the Multi-Media Call Control Service Capability Feature (SCF) aspects of the interface. 
All aspects of the Multi-Media Call Control SCF are defined here, these being: 

Sequence Diagrams 

Class Diagrams 

Interface specification plus detailed method descriptions 

State Transition diagrams 

Data definitions 

IDL Description of the interfaces 

WSDL Description of the interfaces 

Reference to the Java API description of the interfaces 

The process by which this task is accomplished is through the use of object modelling techniques described by the 
Unified Modelling Language (UML). 

This specification has been defined joindy between 3GPP TSG CN WG5, ETSI SPAN 12 and the Parlay Consortium, 
in co-operation with a number of JAJN'"^ Community member companies. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 29.198-1 "Open Service Access; Application Programming Interface; Part 1: 

Overview" . 

[2] 3GPP TS 22.127: "Stage 1 Service Requirement for the Open Service Access (OSA) (Release 5)". 

[3] 3GPP TS 23.127: "Virtual Home Environment (Release 5)". 

[4] 3GPP TS 22.002: "Circuit Bearer Services Supported by a PLMN" . 

[5] ISO 4217 (1995): "Codes for the representation of currencies and funds ". 

[6] 3GPP TS 24.002: "GSM-UMTS PubHc Land Mobile Network (PLMN) Access Reference 

Configuration". 
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[7] 3GPP TS 22.003: "Circuit Teleservices supported by a Public Land Mobile Network (PLMN)". 

3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TS 29.198-1 [1] apply. 

3.2 Abbreviations 

For the purposes of the present document, the abbreviations given in TS 29.198-1 [1] apply. 
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4 MultiMedia Call Control Service Sequence Diagrams 

4.1 Barring for media combined with call routing, alternative 1 

This sequence illustrates how one application can influence both the call routing and the media stream establishment of 
one call. 

In this sequence there is one application handling both the media barring and the routing of the call. 



: (Logical 
View::lpAppLoaic) 



IpAppMultiMediaCallControlManager 



IpAppMultiMediaCallLeg 



P^AJltiMediaCallControlManaae^ 



IpMultiMediaCall 



1: new() 



4: "forward event" 



re^ 



<^ 



(t 



5:re«() 



8: "forward event' 



2: createNotification( ) 

3:reportNotification( ) 

I 

I 
I 

^D 

6:mediaStreamMonitorReq( ; 



-^ 



7:mediaStreamMonitorRes( 



9:mediaStreamAllow( ) 



1 0: createAndRouteCdlLegReq( 



12: "forward event" 



11:mediaStreamMonitorRes( ) 



13:hnediaStream/!|low( ) 



IpMultiMediaCallLeg 



1: The application creates a AppMultiMediaCallControUVIanager interface in order to handle callback methods. 

2: The application expresses interest in all calls from subscriber A. Since createNotification is used and not 
createMediaNotification all calls are reported regardless of the media used. 

3: A makes a call with the SIP INVITE with SDP media stream indicating video. The application is notified. 

4: The event is forwarded to the application. 

5: The application creates a new AppMultiMediaCallLeg interface to receive callbacks. 

6: The application sets a monitor on video media streams to be established (added) for the indicated leg. 

7: Since the video media stream was included in the SIP invite, the media streams monitored will be returned in the 
monitor result. 
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8: The event is forwarded to the application. 

9: The application denies the video media stream, i.e., it is not included in the allowed media streams. This 
corresponds to removing the media stream from the setup. 

10: The application requests to reroute the call to a different destination (or the same one...) 

1 1 : Later in the call the A party tries to establish a lower bandwidth video media stream. This is again reported with 
MediaStreamMonitorRes. 

12: The event is forwarded. 

13: This time the application allows the establishment of the media stream by including the media stream in the allowed 
list. 
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4.2 Barring for media combined with call routing, alternative 2 

This sequence illustrates how one application can influence both the call routing and the media establishment of one 
call. 

Media estabhshment and call establishment are regarded separately by the application. 

From the gateway point of view it can actually be regarded as two separately triggered applications, one for media 
control and one for routing. This is also the way that it is shown here, for clarity. 

However, an implementation of the application could combine the media logic and call logic in one object. 



-^ 






S. repprtNotificalon( ) 



-^ 



-^ 



tr- 



^ 



9.rEporLMediaNolificaban( ) 



-^ 



12. create AndFjtoifleC all Leg Req( ) 



4: mediaStreamAllG 



ISdfflsagrC^i; ) 



-^ 



-^ 



-^(} 



19: reFarMediaNabfication( 



21:mediaStreamAlloii< 



22dffl3H'ffiC^l() 



-^ 



-^ 



-^ 



1: The application creates a new AppMultiMediaCallControUVIanager interface. 

2: The application expresses interest in all calls from subscriber A for rerouting purposes. 

3: The application creates a new AppMultiMediaCallControlManager interface. This is to be used for the media 
control only. 

4: Separately the application expresses interest is some media streams for calls from and to A. The request indicates 
interrupt mode. 

5: Subscriber A makes a call with the SIP INVITE with SDP media stream indicating video. Since the media 
establishment is combined with the SIP INVITE message, both applications are triggered (not necessarily in the order 
shown). 

Here the call application is notified about the call setup. 
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6: The event is forwarded to the call control application. 

7: The call control application creates a new AppMultiMediaCall interface. 

8: The call control application creates a new AppMultiMediaCallLeg interface. 

9: The media application is notified about the call setup. All media streams from the setup will be indicated. 

10: The event is forwarded to the media application. 

1 1 : The call control application creates a new AppMultiMediaCallLeg interface. 

12: The call application decides to reroute the call to another address. Included in the request are monitors on answer 
and call end. 

However, since the media was also triggered in mode interrupt the call will not proceed until the media streams are 
confirmed or rejected. 

14: The application allows the audio media stream, but refuses the high bandwidth video, by excluding it from the 
allowed list. Since both call processing and media handling is now acknowledged, the call routing can continue (with a 
changed SDP parameter reflecting the manipulated media). 

15: The Media application is no longer interested in the call. 

16: When the B subscriber answers the call application is notified. 

17: The event is forwarded to the call application. 

19: When later in the call A tries to establish a lower bandwidth video stream the media application is triggered. 

20: The triggering is forwarded to the media application. 

21 : The application now allows the establishment of the media stream by including the media stream in the 
mediaStreamAUow list. 

22: The media application is no longer interested in the call. 
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4.3 Barring for media, simple 



This sequence illustrates how an apphcation can block the establishment of video streams for a certain user. 



: (Logical 
View::bAppLoqic) 



IpAppM ul ti Med iaCal I Co ntrolM anaq er 

I 

1: new() 



IpMultiMediaCallControlMan.. 



2: createMediaNotification( ) 



^ 



3: reportMediaNotification( 



4: "forward event" 



ft 



^^ 



5: mediaStreamAlloWr) 



6: deassignCalll 



IpMultiMediaCall 



IpMultiMediaCallLeq 



-^ 



1: The application starts a new AppMultiMediaCallControlManager interface for reception of callbacks. 

2: The application expresses interest in all calls from or to subscriber A that use video. The just created App interface 
is given as the callback interface. 

3: Subscriber A makes a call with the SIP INVITE with SDP media stream indicating video. 

4: The message is forwarded to the application. 

5: The application indicates that the setup of the media stream is not allowed by not including the media stream in the 
allowed list. This has the effect of suppressing the video capabilities in the setup. 

6: The application is no longer interested in the call. 

New attempts to open video streams will again be indicated with a createMediaNotification. 



ETSI 



3GPP TS 29.198-04-4 version 5.0.0 Release 5 



14 



ETSI TS 129 198-4-4 V5.0.0 (2002-06) 



4.4 Call Volume charging supervision 

This sequence illustrates how an apphcation may supervise a call based on the number of bytes that are exchanged. 



: (Logical 



^ ^ : IpAppUICall 

View::lpAppLoqicl IpAppMultiMediaCallControlManaqer IpA cp Mult IMedia Call IpMultlMediaCal 

1: new() 



(T 



r 



r 



(f- 



-^ 



2: setCallback{ ) ' 



all{)U 



5: routeReq( ) 



7: "forward event" 



6: routeRes( ) 



8: roiJiteReq( 



10: "forward event" 



11: superviseVolumeReq{ ) 



: 'lorward 



13: 'lorward event" 



12: supervlseVolumeReq{ 



1 17: "forward event" 



14: crekteUICalK ) 
sendlnfoAndCollectf^eq( ) 



19: super\iiseVolumeReq{ ) 



IControlMan... IpMultiMedlaCall 



-^ 



-^ 




■pdinf oAndCollectRes( ) 



-^ 



-^ 



: bUICal 



-^ 



IpUIManaqef : 
I pU I Manager 



-^ 



1: The application creates a new interface to receive callbacks on the call control manager. 

2: The created interface is set as the callback interface for the call control manager. 

3: The application creates a new interface to receive callback on the call. 

4: The application requests the creation of a call. 

5: The application initiates the call by routing to the origination. This will implicitly create a call leg. The application 
requests a notification when the party answers. 

6: When the A party answers the application is notified. 

7: The message is forwarded to the logic. 

8: The application also routes the call to the destination. This implicitly creates a call leg. The application requests to 
be notified on answer of the B-party. 



ETSI 



3GPP TS 29.1 98-04-4 version 5.0.0 Release 5 1 5 ETSI TS 1 29 1 98-4-4 V5.0.0 (2002-06) 

9: When the B-party answers the application is notified. 

10: The message is forwarded to the logic. 

1 1 : The application requests to supervise the call. In the request the application specifies a limit on the amount of bytes 
that may be transferred. The application specifies that if the limit is reached the application should be notified. 

12: When the limit is reached a notification is send to the application. 

13: The message is forwarded to the logic. 

15: The application plays an announcement to the user, asking whether the user wants to end the call or continue the 
call. 

16: When the user answers whether the call should continue. 

17: The message is forwarded to the logic. 

18: The Ulcall is released, since no further announcements are needed. 

19: In case the user answers that the call should continue, the supervision is reset with a new maximum number of 
allowed bytes, (note that this might have charging consequences, not shown) 

20: If the user answered that the call should not continue, the call is released. 
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Class Diagrams 



«lnterface» 
IpAppMulfPartyCallControlManager 

(from mpccs) 

H'eportNotificationO 

■:allAborted() 

^tnanagerlnterruptedO 
■•tTianagerResumedO 
■*tallOverloadEncountered() 
*tallOverloadCeased() 



«lnterface» 
IpAppMulfPartyCall 

(from mpccs) 

O^r^etlnfoResO 
-^^etlnfoErrQ 
^^uperviseResO 
•feuperviseErrO 
%;allEnded() 
%;reateAndRouteCallLegErr() 



«lnterface» 
IpAppCallLeg 

(from mpccs) 

■•feventReportResO 
■*eventReportErr() 
■•attachMediaResO 
0-;" *attachMediaErr() 
■•detach MediaResO 
■•detach MediaErrO 
*yetlnfoRes() 
•getlnfoErrO 
■•routeErrO 
■^uperviseResO 
■•superviseErrO 
^:allLegEnded() 



«lnterface» 
I pAppMulf MediaCa IIC ontrol Manager 

(from mmccs) 



JeportMediaNotificationO 



«uses» 



«lnterface» 
IpMultiMediaCallControlManager 

(from mmccs) 

B^reateMediaNotificationO 
HfestroyMediaNotificationO 

thangeMediaNotificationO 



getMediaNotificationO 



«lnterface» 
IpAppMulfMediaCall 

(from mmccs) 



^uperviseVolumeResO 
^uperviseVolumeErrO 



0..r 



«lnterface» 
IpMultiMediaCall 

(from mmccs) 



superviseVolumeReqO 



0..n 



«lnterface» 
IpAppMultiMediaCallLeg 

(from mmccs) 



ediaStreamlVbnitorResO 



«lnterface» 
IpMultiMediaCallLeg 

(from mmccs) 



ediaStreamAllowO 
ediaStreamWbnitorReqO 
etMediaStreamsO 



Figure: Application Interfaces 
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«lnterface» 

IpMultiPartyCallControl Manager 

(from mpccs) 



'*createCall() 
;*createNotification() 
'*ClestroyNotification() 
'*ChangeNotification() 
'*c<deprecated» getNotificationQ 
*BetCallLoadControl() 
^<new» enableNotificationsO 
'*«new>> disableNotifications() 
^<new» getNextNotificationO 



'\ 



«lnterface» 

IpMuK MediaCallConlrolManager 

(from mmccs) 

pcreateMediaNotificationO 
pdestroyMediaNotificationO 
PcfiangeMediaNotificationQ 
PBetMediaNotificationO 



«lnterface» 

IpMultiPartyCall 

(from mpccs) 



*BetCallLegs() 

^reateCallLegO 

^create And RouteCal I Leg Req () 

%elease() 

•beassignCallO 

*getlnfoReq() 

*setChargePlan() 

^tAdviceOfChargeO 

Supervise ReqO 

A 



0..I1 



«lnterface» 

IpMultiMediaCall 

(from mmccs) 

bupervi seVolume Req 



«lnterface» 
IpCallLeg 

(from mpccs) 



■•routeReqO 

^ventReportReqO 

*release() 

*getlnfoFteqO 

%etCall() 

•attach Media ReqO 

•tietachMediaReqO 

♦getCurienlDeainationAddrBSsO 

*DontinuePiDcessi ng() 

'•setCtiargePlanO 
l^etAdviceOfCtiargeO 
KuperviseReqO 
Jea3Bign() 



0..rL 



«lnterface» 
IpMultiMediaCallLeg 

(from mmccs) 



0..n 



%nediaStreamAllow() 
^fnediaStreamMonitorReqO 
pBetMediaStreamsO 



«lnterface» 

IpMultiMediaStream 

(from mmccs) 



l^ubtractO 



Figure: Service interfaces 



6 MultiMedia Call Control Service Interface Classes 

The MultiMedia Call Control service enhances the functionality of the MultiParty Call Control Service with multi- 
media capabilities. 

The MultiMedia Call Control Service is represented by the IpMultiMediaCallConti-olManager, IpMultiMediaCall, 
IpMultiMediaCallLeg and IpMultiMediaStream interfaces that interface to services provided by the network. Some 
methods are asynchronous, in that they do not lock a thread into waiting whilst a transaction performs. In this way, the 
client machine can handle many more calls, than one that uses synchronous message calls. To handle responses and 
reports, the developer must implement IpAppMultiMediaCallControlManager, IpAppMultiMediaCall and 
IpAppMultiMediaCallLeg to provide the callback mechanism. 

To handle the multi-media aspects of a call the concept of media stream is introduced. A media stream is bi-directional 
media stream and is associated with a call leg. These media streams are usually negotiated between the terminals in the 
call. The multi-party Call Service gives the application control over the media streams associated with the legs in a 
multi-media call in the following way: 

• • the application can be triggered on the establishment of a media stream that meets the application defined 
characteristics. 

• • the application can monitor on the establishment (addition) or release (subtraction) of media streams of an 
ongoing call. 

• • the application can allow or deny the establishment of media streams (provided the stream establishment was 
monitored/notified in interrupt mode). 

• • the application can explicitly subtract already established media streams. 

• • the application can request the media streams associated with a specific leg. 
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6.1 Interface Class IpMultiMediaCallControlManager 

Inherits from: IpMultiPartyCallControlManager 

The Muhi Media Call Control Manager is the factory interface for creating multimedia calls. The multi-media call 
control manager interface provides the management functions to the multi-media call control service. The application 
programmer can use this interface to create, destroy, change and get media stream related notifications. 



«lnterface» 
IpMultiMediaCallControlManager 



createMediaNotification (applnterface : in IpAppMultiMediaCallControlManagerRef, 
notificationMediaRequest : in TpNotificationMediaRequest) : TpAssignmentID 

destroyMediaNotification (assignmentID : in TpAssignmentID) : void 

changeMediaNotification (assignmentID : in TpAssignmentID, notificationMediaRequest : in 
TpNotificationMediaRequest) : void 

getMediaNotification () : TpMediaNotificationRequestedSet 



6.1.1 Method createMediaNotificationQ 

This method is used to create media stream notifications so that events can be sent to the application. 

This applies both to callsetup media (e.g., SIP initial INVITE or H.323 with faststart) and for media setup during the 
call. 

This is the first step an application has to do to get initial notifications of media streams happening in the network. 
When such an event happens, the application will be informed by reportMediaNotification(). In case the application is 
interested in other events during the context of a particular call session it has to use the mediaStreamMonitorReqO 
method on the Multi-Media call leg object. 

The createMediaNotification method is purely intended for applications to indicate their interest to be notified when 
certain media stream events take place. It is possible to subscribe to a certain media stream event for a whole range of 
addresses, e.g. the application can indicate it wishes to be informed when a call is made to any number starting with 
800. 

If some application already requested notifications with criteria that overlap the specified criteria, the request is refused 
with P_INVALID_CRITERIA. The criteria are said to overlap if both originating and terminating ranges overlap and 
the same number plan is used. 

If the same application requests two notifications with exactly the same criteria but different callback references, the 
second callback will be treated as an additional callback. Both notifications will share the same assignmentID. The 
gateway will always use the most recent callback. In case this most recent callback fails the second most recent is used. 
In case the createMediaNotification contains no callback, at the moment the application needs to be informed the 
gateway will use as callback the one that has been registered by setCallback(). 

Returns assignmentID: Specifies the ID assigned by the multi-media call control manager interface for this newly- 
created notification. 

Parameters 

applnterface : in IpAppMultiMediaCallControlManagerRef 

Specifies a reference to the application interface, which is used for callbacks. 
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notif IcationMediaRequest : in TpNotif IcationMediaRequest 

The mediaMonitorMode is a parameter of TpMediaStreamRequest and can be in interrupt or in notify mode. If in 
interrupt mode the application has to specify which media streams are allowed by calling mediaStreamAllow on the 
callLeg. 

The notificationMediaRequest parameter specifies the event specific criteria used by the application to define the event 
required. This is the media portion of the criteria. Only events that meet the notificationMediaRequest are reported. 

Individual addresses or address ranges may be specified for the destination and/or origination. 

Returns 
TpAssignmentID 

Raises 

TpCommonExceptions, P_INVALID_CRITERIA, P_INVALID_INTERFACE_TYPE, 
P_INVALID_EVENT_TYPE 

6.1.2 Method destroyMediaNotificationQ 

This method is used by the application to disable Multi Media Channel notifications 

Parameters 

assignmentID : in TpAssignmentID 

Specifies the assignment ID given by the Multi Media call control manager interface when the previous 
enableMediaNotification was called. If the assignment ID does not correspond to one of the valid assignment IDs, the 
exception P_INVALID_ASSIGNMENTID will be raised. 

Raises 
TpCommonExceptions 

6.1.3 Method changeMediaNotificationQ 

This method is used by the application to change the event criteria introduced with createMediaNotification. Any stored 
criteria associated with the specified assignmentID will be replaced with the specified criteria. 

Parameters 

assignmentID : in TpAssignmentID 

Specifies the ID assigned by the multi -media call control manager interface for the media stream notification. If two 
callbacks have been registered under this assignment ID both of them will be disabled. 

notificationMediaRequest : in TpNotif icationMediaRequest 

Specifies the new set of event specific criteria used by the application to define the event required. Only events that 
meet these criteria are reported. 

Raises 

TpCommonExceptions, P_INVALID_ASSIGNMENT_ID, P_INVALID_CRITERIA, 
P_INVALID_EVENT_TYPE 

6.1.4 Method getMediaNotificationQ 

This method is used by the application to query the event criteria set with createMediaNotification or 
changeMediaNotification. 

Returns notificationsMediaRequested: Specifies the notifications that have been requested by the application. 
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Parameters 

No Parameters were identified for this method 

Returns 
TpMediaNotificationRequestedSet 

Raises 
TpCommonExceptions 

6.2 Interface Class IpAppMultiMediaCallControlManager 

Inherits from: IpAppMultiPartyCallControlManager 

The Muhi Media call control manager application interface provides the application call control management functions 
to the multi media call control service. 



«lnterface» 
IpAppMultiMediaCallControlManager 



reportMediaNotification (callReference : in TpMultiMediaCallldentifier, callLegReferenceSet : in 
TpMultiMediaCallLegldentifierSet, mediaStreams : in TpMediaStreamSet, type : in 
TpMediaStreamEventType, assignmentID : in TpAssignmentID) : TpAppMultiMediaCallBack 



6.2.1 Method reportMediaNotification() 

This method is used to inform the application about the establishment of media streams. 

If the corresponding monitor was in interrupt mode, then the application has to allow or deny the streams using 
mediaStreamAUowO method. 

Returns applnterface : Specifies a reference to the application interface which implements the callback interface for the 
new call. 

Returns appMultiMediaCallBack: Specifies references to the application interface which implements the callback 
interface for the new multi-media call and/or new call leg. This parameter may be null if the notification is being given 
in NOTIFY mode 

Parameters 

callReference : in TpMultiMediaCallldentifier 

Specifies the call interface on which the media streams were added or subtracted. It also gives the corresponding 
sessionlD. 

callLegReferenceSet : in TpMultiMediaCallLegldentif ierSet 

Specifies set of all callLeg references (interface and sessionlD) for which the media streams were established or 
subtracted. 

First in the set is the reference to the originating callLeg. It indicates the call leg related to the originating party. In case 
there is a destination call leg this will be the second leg in the set. from the notificationlnfo can be found on whose 
behalf the notification was sent. 

However, this parameter will be null if the notification is being given in NOTIFY mode 
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mediaSt reams : in TpMediaStreamSet 

Specifies all the media streams that are established. Note that this can be more media streams than requested in the 
createMediaNotification, e.g., when faststart is used in H.323 or in SIP when an INVITE method with SDP media 
stream parameters is used. 

type : in TpMediaStreamEventType 

Refers to the type of event on the media stream, i.e., added or subtracted. 

assignment ID : in TpAssignmentID 

Specifies the assignment id which was returned by the createMediaNotification() method. The application can use 
assignment id to associate events with event specific criteria and to act accordingly. 

Returns 
TpAppMultiMediaCallBack 

6.3 Interface Class IpMultiMediaCall 

Inherits from: IpMultiPartyCall 



«lnterface» 
IpMultiMediaCall 



superviseVolumeReq (callSessionID : in TpSessionID, volume : in TpCallSuperviseVolume, treatment : in 
TpCallSuperviselreatment) : void 



6.3.1 Method superviseVolumeReqO 

The application calls this method to supervise a call. The application can set a granted data volume this call. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

volvime : in TpCallSuperviseVolume 

Specifies the granted time in milliseconds for the connection. 

treatment : in TpCallSuperviseTreatment 

Specifies how the network should react after the granted volume expired. 

Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 

6.4 Interface Class IpAppMultiMediaCall 

Inherits from: IpAppMultiPartyCall 
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The application multi-media call interface contains the callbacks that will be used from the multi-media call interface 
for asynchronous results to requests performed by the application. The application should implement this interface. 



«lnterface» 
IpAppMultiMediaCall 



superviseVolumeRes (callSessionID : in TpSessionID, report : in TpCallSuperviseReport, usedVolume : in 
TpCallSuperviseVolume) : void 

superviseVolumeErr (callSessionID : in TpSessionID, errorlndication : in TpCallError) : void 



6.4.1 Method superviseVolumeRes() 



This asynchronous method reports a call supervision event to the application when it has indicated its interest in these 
kind of events. 

It is also called when the connection is terminated before the supervision event occurs. Furthermore, this method is 
invoked as a response to the request also when a tariff switch happens in the network during an active call. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call 

report : in TpCallSuperviseReport 

Specifies the situation which triggered the sending of the call supervision response. 

usedVolvime : in TpCallSuperviseVolume 

Specifies the used time for the call supervision (in milliseconds). 

6.4.2 Method superviseVolumeErr() 

This asynchronous method reports a call supervision error to the application. 

Parameters 

callSessionID : in TpSessionID 

Specifies the call session ID of the call. 

errorlndication : in TpCallError 

Specifies the error which led to the original request failing. 

6.5 Interface Class IpMultiMediaCallLeg 

Inherits from: IpCallLeg 

The Multi-Media call leg represents the signalling relationship between the call and an address. Associated with the 
signalling relationship there can be multiple media channels. Media channels can be started and stopped by the 
terminals themselves. The application can monitor on these changes and influence them. 
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«lnterface» 
IpMultiMediaCallLeg 



mediaStreamAllow (callLegSessionID : in TpSessionID, mediaStreamList : in TpSessionlDSet) : void 

mediaStreamMonitorReq (callLegSessionID : in TpSessionID, mediaStreamEventCriteria : in 
TpMediaStreamRequestSet) : void 

getMediaStreams (callLegSessionID : in TpSessionID) : TpMediaStreamSet 



6.5.1 Method mediaStreamAllow() 

This method can be used to allow setup of a media stream that was reported by a mediaStreamMonitorRes method. 

Parameters 

callLegSessionID : in TpSessionID 

Specifies the call leg session ID of the call leg. 

mediaStreamList : in TpSessionlDSet 

Refers to the media streams (sessionlDs) as received in the mediaStreamMonitorRes() or in the 
reportMediaNotificationO that is allowed to be established. 

Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 

6.5.2 Method mediaStreamMonitorReqO 

With this method the application can set monitors on the addition and subtraction of media streams. The monitors can 
either be general or restricted to certain types of codecs. 

Monitoring on addition of media streams can be done in either interrupt of notify mode. In the first case the application 
has to allow or deny the establishment of the stream with mediaStreamAllow. 

Monitoring on subtraction of media streams is only allowed in notify mode. 

Parameters 

callLegSessionID : in TpSessionID 

Specifies the session ID of the call leg. 

mediaStreamEventCriteria : in TpMediaStreamRequestSet 

Specifies the event specific criteria used by the application to define the event required. The mediaMonitorMode .is a 
parameter of TpMediaStreamRequest and can be in interrupt or in notify mode. If in interrupt mode the application has 
to respond with mediaStreamAllow(). 
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Raises 

TpCommonExceptions, P_INVALID_SESSION_ID, P_INVALID_CRITERIA, 
P_INVALID_EVENT_TYPE 

6.5.3 Method getMediaStreams() 

This method is used to return all currently established media streams for the leg. 

Parameters 

callLegSessionID : in TpSessionID 

This method is used to return all currently open media channels for the leg. 

Returns 
TpMediaStreamSet 

Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 

6.6 Interface Class IpAppMultiMediaCallLeg 

Inherits from: IpAppCallLeg 

The application multi-media call leg interface contains the callbacks that will be called from the multi-media call leg for 
asynchronous results to requests performed by the application. The application should implement this interface. 



«lnterface» 
IpAppMultiMediaCallLeg 



mediaStreamMonitorRes (callLegSessionID : in TpSessionID, streams : in TpMediaStreamSet, type : in 
TpMediaStreamEventType) : void 



6.6.1 Method mediaStreamMonitorRes() 

This method is used to inform the application about the media streams that are being established (added) or subtracted. 

If the corresponding request was done in interrupt mode, the application has to allow or deny the media streams using 
mediaStreamAllow(). 

Parameters 

callLegSessionID : in TpSessionID 

Specifies the session ID of the call leg for which the media channels are opened or closed. 

streams : in TpMediaStreamSet 

Specifies all the media streams that are added. Note that this can be more media streams than requested in the 
createMediaNotification, e.g., when faststart is used in H.323 or SIP INVITE with SDP media stream parameters is 
used. 
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type : in TpMediaStreaitiEventType 

Refers to the type of event on the media stream, i.e., added or subtraced. 

6.7 Interface Class IpMultlMediaStream 

Inherits from: IpService 

The Multi Media Stream Interface represents a bi-directional information stream associated with a call leg. Currently, 
the only available method is to subtract the media stream. 



«lnterface» 
IpMultiMediaStream 



subtract (mediaStreamSessionID : in TpSessionID) : void 



6.7.1 Method subtract() 

This method can be used to subtract the multi-media stream. 

Parameters 

mediaStreamSessionID : in TpSessionID 

Specifies the sessionID for the media stream. 

Raises 

TpCommonExceptions , P_INVALID_SESSION_ID 



7 Multi Media Call Control Service State Transition 

Diagrams 

There are no State Transition Diagrams for the MultiMedia Call Control Service package 
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8 



Multi-Media Call Control Data Definitions 



This clause provides the Multi-Media call control data definitions necessary to support the API specification. 
The general format of a data definition specification is described below. 

• Data Type 

This shows the name of the data type. 

• Description 

This describes the data type. 

• Tabular Specification 

This specifies the data types and values of the data type. 

• Example 

If relevant, an example is shown to illustrate the data type. 

All data types referenced in the present document but not defined in this clause are defined either in the common call 
control data definitions in 3GPP TS 29.198-4-1 or in the common data definitions which may be found in 
3GPPTS 29.198-2. 



8.1 



Event Notification Data Definitions 



8.1.1 TpMediaStreamRequestSet 

Defines a Numbered Set of Data Elements of TpMediaStreamRequest 

8.1.2 TpMediaStreamRequest 

Defines the Sequence of Data Elements that specify the type of media stream. 



Sequence Element Name 


Sequence Element Type 


Direction 


TpMediaStreamDirection 


DataTypeRequest 


TpMediaStreamDataTypeRequest 


MediaMonitorMode 


TpCallMonitorMode 



8.1.3 TpMediaStreamDirection 

Defines the direction in which the media stream is established (as seen from the leg). 



Name 


Value 


Description 


P_SEND_ONLY 





Indicates that the offerer is only wiUing to send this media stream 


P_RECEIVE_ONLY 


1 


Indicates that the offerer is only willing to receive this media stream 


P_SEND_RECEIVE 


2 


Indicates that the offerer is willing to send and receive this media stream 
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8.1 .4 TpMediaStreamDataTypeRequest 



Defines the Tagged Choice of Data Elements that specify the media type and associated codecs that are of 
interest. 





Tag Element Type 






TpMediaType 





Tag Element Value 


Choice Element Type 


Choice Element Name 


P_AUDIO 


TpAudioCapabilitiesType 


Audio 


P_VIDEO 


TpVideoCapabilitiesType 


Video 


P_DATA 


TpDataCapabilities 


Data 



8.1.5 TpAudioCapabilitiesType 

Defines the audio codec. The requested capabiHties can be indicated by adding the values together (i.e., a logical OR 
function), e.g., 28 indicates interest in all G.722 codes (4+8+16). 



Name 


Value 


Description 


P_G711_64K 


1 


g.7 1 1 on 64k, both alaw and ulaw 


P_G711_56K 


2 


g.71 1 on 56k, both alaw and ulaw 


P_G722_64K 


4 




P_G7 22_5 6K 


8 




P_G7 22_4 8K 


16 




P_G7231 


32 




P_G7 28 


64 




P_G7 2 9 


128 




P_G7 2 9_ANNEX_A 


256 




P_IS1172 


512 




P_IS1318 


1024 




P_G72 9_ANNEXB 


2048 




P_G7 2 9_ANNEX_A_AND_B 


4096 




P_G7 231_ANNEX_C 


8192 




P_GSM_FULLRATE 


16384 




P_GSM_HALFRATE 


32768 




P_GSM_ENHANCED 


65536 





8.1.6 TpVideoCapabilitiesType 

Defines the video codec. The requested capabilities can be indicated by adding the values together (i.e., a logical OR 
function), e.g., 3 indicates both H.261 and H.262 codecs. 



Name 


Value 


Description 


P_H2 61 


1 




P_H2 62 


2 




P_H2 63 


4 




P_IS11172 


8 
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8.1.7 TpDataCapabilities 



A Tplnt32 defining the minimum maxBitRate in bit/s. I.e., all data media streams whose maxBitRate exceeds this 
number are reported. 



8.1.8 TpMediaStreamEventType 

Defines the action performed on the media stream. 



Name 


Value 


Description 


P_MED IA_STREAM_ADDED 





The media stream is added 


P_MEDIA_STREAM_SUBTRACTED 


1 


The media stream is subtracted. 



8.1.9 TpMediaStreamSet 

Defines a Numbered Set of Data Elements of TpMediaStream 

8.1.10 TpMediaStream 

Defines the Sequence of Data Elements that specify the type of media stream. 



Sequence Element Name 


Sequence Element Type 


Direction 


TpMediaStreamDirection 


DataType 


TpMediaStreamDataType 


ChannelSessionID 


TpSessionID 


MediaStream 


IpMultiMediaStream 



8.1.11 TpMediaStreamDataType 

Defines the type of the reported media stream. It is identical to TpMediaStreamDataTypeRequest, only now the 
values are not used as a mask, but as the actual codec should be indicated for audio and video. For data the actual 
maximum bit rate is indicated. 

8.2 Multi-Media Call Control Data Definitions 

8.2.1 IpMultiMediaCall 

Defines the address of an IpMultiMediaCall Interface. 

8.2.2 IpMultiMediaCallRef 

Defines a Reference to type IpMultiMediaCall. 

8.2.3 IpAppMultiMediaCall 

Defines the address of an IpAppMultiMediaCall Interface. 

8.2.4 IpAppMultiMediaCallRef 

Defines a Reference to type IpAppMultiMediaCall. 
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8.2.5 IpMultiMediaCallLeg 

Defines the address of an IpMultiMediaCallLeg Interface. 

8.2.6 IpMultiMediaCallLegRef 

Defines a Reference to type IpMultiMediaCallLeg. 

8.2.7 IpAppMultiMediaCallLeg 

Defines the address of an IpAppMultiMediaCallLeg Interface. 

8.2.8 IpAppMultiMediaCallLegRef 

Defines a Reference to type IpAppMultiMediaCallLeg. 

8.2.9 TpAppMultiMediaCallLegRefSet 

Defines a Numbered Set of Data Elements of IpAppMultiMediaCallLegRef 

8.2.1 TpMultiMediaCallldentifier 

Defines the Sequence of Data Elements that unambiguously specify the MultiMediaCall object 



Sequence Element Name 


Sequence Element Type 


Sequence Element Description 


MMCallReference 


IpMultiMediaCallRef 


This element specifies the interface reference for the call object. 


MMCallSessionID 


TpSessionID 


This element specifies the call session ID of the call created. 



8.2.1 1 TpMultiMediaCallldentifierSet 

Defines a Numbered Set of Data Elements of TpMultiMediaCallldentifier 

8.2.1 2 TpMultiMediaCallLegldentifier 

Defines the Sequence of Data Elements that unambiguously specify the Call Leg object 



Sequence Element Name 


Sequence Element Type 


Sequence Element Description 


MMCallLegReference 


IpMultiMediaCallLegRef 


This element specifies the interface reference for the callLeg object. 


MMCallLegSessionID 


TpSessionID 


This element specifies the callLeg session ID of the call created. 



8.2.1 3 IpAppMultiMediaCallControlManager 

Defines the address of an IpAppMultiMediaCallControlManager Interface. 

8.2.14 IpAppMultiMediaCallControlManagerRef 

Defines a Reference to type IpAppMultiMediaCallControlManager. 



ETSI 



3GPP TS 29.198-04-4 version 5.0.0 Release 5 



30 



ETSI TS 129 198-4-4 V5.0.0 (2002-06) 



8.2.15 TpAppMultiMediaCallBack 



Defines the Tagged Choice of Data Elements that references the application callback interfaces 





Tag Element Type 






TpAppMultiMediaCallBackRefType 





Tag Element Value 


Choice Element Type 


Choice Element Name 


P_APP_CALLBACK_UNDEFINED 


NULL 


Undefined 


P_APP_MULT IMED I A_CALL_CALLBACK 


IpAppMultiMediaCallRef 


AppMultiMediaCall 


P_APP_CALL_LEG_CALLBACK 


IpAppMultiMediaCallLegRef 


AppMultiMediaCallLeg 


P_APP„CALL_AND_CALL_LEG_CALLBACK 


TpAppMultiMediaCallLegCallBack 


AppMultiMediaCallAndCallLeg 



8.2.1 6 TpAppMultiMediaCallBackRefType 

Defines the type application call back interface. 



Name 


Value 


Description 


P_APP„CALLBACK_UNDEFINED 





Application Call back interface undefined 


P_APP_MULT IMED I A_CALL_CALLBACK 


1 


Application Multi-Media Call interface referenced 


P_APP_CALL_LEG_CALLBACK 


2 


Application Multi-Media CallLeg interface referenced 


P_APP_CALL_AND_CALL_LEG_CALLBACK 


3 


Application Multi-Media Call and CallLeg interface referenced 



8.2.17 TpAppMultiMediaCallLegCallBack 

Defines the Sequence of Data Elements that references a call and a call leg application interface. 



Sequence Element 
Name 


Sequence Element Type 




AppMultiMediaCall 


IpAppMultiMediaCallRef 




AppCallLegSet 


IpAppMultiMediaCallLegRef Set 


Specifies the set of all call leg call back references. First in the set is the 

reference to the call back of the originating callLeg. In case there is a call 

back to a destination call leg this will be second in the set. 



8.2.18 TpCallSuperviseVolume 



Defines the Sequence of Data Elements that specify the amount of volume that is allowed to be transmitted for the 
specific connection. 



Sequence 
Element Name 


Sequence 
Element Type 


Sequence Element Description 


VolumeQuantity 


Tplnt32 


This data type is identical to a Tplnt32, and defines the quantity of the granted volume that can be 
transmitted for the specific connection. 


VolumeUnit 


Tplnt32 


This data type is identical to a Tplnt32, and defines the unit of the granted volume that can be 
transmitted for the specific connection. 

Unit must be specified as lO'^n number of bytes, where 

n denotes the power. 

When the unit is for example in kilobytes, VolumeUnit must be set to 3. 
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8.2.1 9 TpNotificationMediaRequest 

Defines the Sequence of Data Elements that specify the criteria for a media stream notification 



Sequence Element Name 


Sequence Element Type 


Description 


MediaNotif icationScope 


TpCallNot if icationScope 


Defines the scope of the notification request. 


MediaStreamsRequested 


TpMediaStreamRequestSet 


Defines the media stream events which are requested 



8.2.20 TpMediaNotificationRequested 



Defines the Sequence of Data Elements that specify the criteria relating to event requests. 



Sequence Element Name 


Sequence Element Type 


AppNotif icationMediaRequest 


TpNotificationMediaRequest 


Assignment ID 


Tplnt32 



8.2.21 TpMediaNotificationsRequestedSet 

Defines a numbered Set of Data Elements of TpMediaNotificationRequested 
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Annex A (normative): 

OMG IDL Description of IVIulti-IVIedia Call Control SCF 

The OMG IDL representation of this interface specification is contained in the text file mmccs.idl (contained in archive 
291980404IDL.ZIP) which accompany the present document. 
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Annex B (informative): 

W3C WSDL Description of IVIulti-IVIedia Call Control SCF 

The W3C WSDL representation of this specification is contained in text files (mmccs.wsdl contained in archive 
291980404WSDL.ZIP) which accompanies the present document. 
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Annex C (informative): 

Java API Description of the Call Control SCFs 

The Java API representation of this specification can be obtained from the following URL: 

• Java Call Control ( http ://i cp .org/j sr/de tail/2 1 . i sp ) 

Each JSR webpage contains a table identifying the relationships between the different versions of the Parlay, 
ETSI/OSA, 3GPP/0SA and JAIN SPA specifications. In addition, each JAIN SPA specification version indicates to 
which Parlay, ETSI/OSA and 3GPP/0SA specification versions it corresponds to. 
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